'\" t
.\"     Title: wvtag
.\"    Author: David Bryant <david@wavpack.com>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 2020-04-13
.\"    Manual: WavPack Executable Programs
.\"    Source: WavPack 5.3.0
.\"  Language: English
.\"
.TH "WVTAG" "1" "2020\-04\-13" "WavPack 5\&.3\&.0" "WavPack Executable Programs"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
wvtag \- metadata utility for wavpack files
.SH "SYNOPSIS"
.HP \w'\fBwvtag\fR\ 'u
\fBwvtag\fR [\fB\fI\-options\fR\fR] \fB\fIINFILE\fR\fR...
.SH "DESCRIPTION"
.PP
\fBwvtag\fR
applies the specified metadata operation(s) to each of the specified WavPack source file(s) in this order: clean, import, delete, write, extract, list\&. Note that WavPack metadata is stored in APEv2 tags, and this tool will automatically import from an ID3v1 tag if it is the only tag present on the source file, and that ID3v1 tag will be deleted and replaced with an APEv2 tag if an edit is requested\&.
.SH "OPTIONS"
.PP
.PP
\fB\-\-allow\-huge\-tags\fR
.RS 4
allow tag data up to 16 MB (embedding > 1 MB is not recommended for portable devices and may not work with some programs including WavPack pre\-4\&.70)
.RE
.PP
\fB\-c\fR
.RS 4
extract cuesheet only to
stdout
(equivalent to
\fB\-x \fR\fB\(lqcuesheet\(rq\fR)
.RE
.PP
\fB\-cc\fR
.RS 4
extract cuesheet to
source\-name\&.cue
file in same directory as source file (equivalent to
\fB\-xx \fR\fB\(lqcuesheet=%a\&.cue\(rq\fR)
.RE
.PP
\fB\-\-clean\fR, \fB\-\-clear\fR
.RS 4
clean all items from tag (done first)
.RE
.PP
\fB\-d \fR\fB\(lq\fIField\fR\(rq\fR
.RS 4
delete specified metadata item (text or binary)
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
this help display
.RE
.PP
\fB\-\-import\-id3\fR
.RS 4
import applicable tag items from ID3v2\&.3 tag present in DSF (and other) files into APEv2 tag (if there are > 1 MB cover images present add
\fB\-\-allow\-huge\-tags\fR
to include them)
.RE
.PP
\fB\-l\fR, \fB\-\-list\fR
.RS 4
list all tag items (done last)
.RE
.PP
\fB\-\-no\-utf8\-convert\fR
.RS 4
don\*(Aqt recode passed tags from local encoding to UTF\-8, assume they are in UTF\-8 already
.RE
.PP
\fB\-q\fR
.RS 4
quiet (keep console output to a minimum)
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
write program version to
stdout
.RE
.PP
\fB\-w \fR\fB\(lq\fIField\fR=\(rq\fR
.RS 4
delete specified metadata item (text or binary)
.RE
.PP
\fB\-w \fR\fB\(lq\fIField\fR=\fIValue\fR\(rq\fR
.RS 4
write specified text metadata to APEv2 tag
.RE
.PP
\fB\-w \fR\fB\(lq\fIField\fR=@\fIfile\&.ext\fR\(rq\fR
.RS 4
write specified text metadata from file to APEv2 tag, normally used for embedded cuesheets and logs (field names
\(lqCuesheet\(rq
and
\(lqLog\(rq)
.RE
.PP
\fB\-\-write\-binary\-tag \fR\fB\(lq\fIField\fR=@\fIfile\&.ext\fR\(rq\fR
.RS 4
write the specified binary metadata file to APEv2 tag, normally used for cover art with the specified field name
\(lqCover Art (Front)\(rq
.RE
.PP
\fB\-x \fR\fB\(lq\fIField\fR\(rq\fR
.RS 4
extract the specified tag field only to
stdout
.RE
.PP
\fB\-xx \fR\fB\(lq\fIField\fR[=\fIfile\fR]\(rq\fR
.RS 4
extract the specified tag field to named file in same directory as source file; optional filename specification may contain
\fB%a\fR
which is replaced with the audio file base name,
\fB%t\fR
replaced with the tag field name (note: comes from data for binary tags) and
\fB%e\fR
replaced with the extension from the binary tag source file (or
\(lqtxt\(rq
for text tag)\&.
.RE
.PP
\fB\-y\fR
.RS 4
yes to all warnings (use with caution!)
.RE
.SH "SEE ALSO"
.PP
\fBwavpack\fR(1),
\fBwvunpack\fR(1),
\fBwvgain\fR(1)
.PP
Please visit www\&.wavpack\&.com for more information
.SH "COPYRIGHT"
.PP
This manual page was written by David Bryant
<david@wavpack\&.com>\&. Permission is granted to copy, distribute and/or modify this document under the terms of the
BSD
License\&.
.SH "AUTHOR"
.PP
\fBDavid Bryant\fR <\&david@wavpack\&.com\&>
.RS 4
Author
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2020 David Bryant
.br
